home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 April / Macworld (1999-04).dmg / Shareware World / Maths & Science / Convert 1.2.3 / Convert Read Me! < prev    next >
Text File  |  1999-01-23  |  13KB  |  201 lines

  1.                                                                                                                          
  2.  
  3.  
  4.                                                                                                                                     Convert
  5.                                                                                                     Documentation for version 1.2.3
  6.  
  7.  
  8. Overview
  9.  
  10.   The following comprises what little documentation is needed for Convert, the numeric translation master. Convert is the ultimate stand-alone application for anyone who needs to convert various categories of numbers from one unit to another. The application itself was borne out of frustration of not having such a utility with some very specific features.
  11.  
  12.     Over a thousand different conversions are possible. Mac OS’s Drag and Drop is supported. Convert can be driven from the keyboard alone. Balloon Help is supported. Convert is not modal; in other words, you can run Convert in the background. Convert remembers its last screen location; this is especially handy for those lucky enough to have multiple monitors. Currency conversions are supported; useful for those pesky expense reports.
  13.  
  14.     Last, Convert tries its best to provide local language support for menus, dialogs, and makes use of the localization settings found in Mac OS’ Numbers control panel. The popup menus listing the unit names are not localized however, as the complexities are dizzying.
  15.  
  16.  
  17. Paying for Convert
  18.  
  19. Convert has the following pricing:
  20.  
  21.   * 1- 10 single user licenses, $15 per user
  22.   * 20+ single user licenses, $12 per user
  23.   * A Site License costs $500 (roughly equal to 33 users) and covers all locations for your organization within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software.
  24.   * A World-Wide License costs $1800 and it covers all locations for your organization on the planet Earth.
  25.  
  26. Paying for Convert is fairly simple. Open the Register program that accompanies Convert. Enter name, your email address, and the number of single user licenses you to purchase (or Site or Word-Wide licenses). Save or Copy or Print the data from the Register program and send the data and payment to Kagi. More specifics on the Register program to follow. Kagi handles payment processing for Fifth Wave's Convert.
  27.  
  28. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510/652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. 
  29.  
  30. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement it is processed. Payments sent via fax take up to 10 days and if you provide a correct internet email address you will receive an email acknowledgement. 
  31.  
  32. If you are paying with Cash or USD Check you should print the data using the Register application and send it to the address shown on the form, which is: 
  33.  
  34.               Kagi
  35.               1442-A Walnut Street #392-3Z1
  36.               Berkeley, California 94709-1405
  37.               USA
  38.  
  39. You can pay with a wide variety of cash from different countries but at present if you pay via check, it must a check drawn in US Dollars. Kagi cannot accept checks in other currencies, the conversion rate for non-USD checks is around USD 15 per check and that is just not practical.
  40.  
  41. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with payment.
  42.  
  43. Kagi can not invoice your company, you need to act on my behalf and generate the invoice and handle all the paperwork on your end. If you are a corporation and this presents a problem, contact Fifth Wave directly (fwinfo@fifthwave.com, or 408/927-5108) to see if purchase order approval is possible.
  44.  
  45. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed.
  46.  
  47. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed.
  48.  
  49.  
  50. Getting Started
  51.  
  52.     Turn on the Macintosh, as described in Apple’s Getting Started With Your Macintosh manual.  Insert the Convert disk in the Macintosh, wait for the window to appear on the desktop.
  53.  
  54.     To get started, open the Convert application by double-clicking its icon (shown below).  You can also open the application by selecting its icon and choosing Open from the Finder's File menu.
  55.                                                                                                                                  
  56.  
  57.                                                                                                                          Convert Icon
  58.  
  59.     When Convert is opened, you'll see the main window (shown below).
  60.  
  61.                                                                                                                                      
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                                                                                                  Convert window
  74.  
  75.     To close the window, click the close box or choose Close from the File menu.
  76. Closing the window also Quits the application.
  77.  
  78.  
  79. The Menus
  80.  
  81.     This section runs through the menus and menu items that are available to you in Convert.  You can use the File, Edit, and the Options menu.
  82.  
  83. File Menu
  84.     The File menu’s only item is Quit.
  85. •    Choose Quit to close Convert's window and quit the application.
  86.  
  87. Edit Menu
  88.     The Edit menu contains items for Undo, Cut, Copy, Paste, Clear, and Select All. With the exception of Undo and Select All, the items in the Edit menu will function only when text is selected.
  89.  
  90. Options Menu
  91.     The Options menu contains Decimal Places, Separate Thousands, Scientific Notation, Flip Units, Update Currency Prices and SMPTE Frame Rates. Once altered, these settings will be "remembered" until changed again, even after you quit Convert.
  92.  
  93. •    Decimal Places is a hierarchical menu for setting the number of decimal places you desire in your calculated result.
  94. •    Separate Thousands delimits, or separates, thousands with the appropriate mark. This mark is typically a comma (for the U.S.), but technically reflects the settings contained in the Numbers control panel.
  95. •    Scientific Notation determines whether of not the calculated result is displayed using scientific notation or not. Pressing Command-E is the keyboard equivalent for this item.
  96. •    Flip Units inverts the two displayed units for a given category. For example, if one was working in the Temperature category and converting from Celsius to Kelvin, and then wanted to convert from Kelvin to Celsius, instead of manually changing the two popup menus, simply use the Flip Units menu item. Pressing Command-U is the function's keyboard equivalent.
  97. •    Update Currency Prices… displays a dialog allowing you to enter the current market rates for various currencies found around the globe. We've found the Wall Street Journal to be an excellent source for these numbers. The lower left hand side of the dialog shows the last time any of the currencies were updated. The tab key on your keyboard will move you from currency to currency. Hitting the Cancel button exits this dialog without updating any of the currencies.
  98.  Shortcut: Option-clicking on a currency name from the main Convert window brings you directly to the Update Currencies… dialog.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                                                                                         Update Currencies Dialog
  120.  
  121.  
  122.  
  123. There are also a number of internet web sites where up-to-the-minute currency rate information can be found.
  124. •    The SMPTE Frame Rates menu allows for the manipulation of frame rates when the Digital Video category is selected. This menu is dimmed and unavailable unless the Digital Video cetegory is active.
  125.  
  126. Using Convert
  127.  
  128.     Using Convert is very simple. First choose what Category of conversion you wish to perform. This is accomplished by either using the Category popup menu found in the upper left area of the Convert window, or you may use the "[" or "]" keys on the keyboard to make changes.
  129.  
  130.     Three more things need to be done, and they may be performed in any order. First, choose the From unit type by manipulating the From unit popup menu. This menu is located in the upper right of the Convert window. Second, choose the To unit type from the popup menu directly below. Last, type the number you wish to convert from in the upper left text edit box, and as you type the number is automatically converted and appears in the lower left text edit box.
  131.  
  132.     Note that the unit type popup menus may be controlled from the keyboard by using the up and down arrows, both with the shift key and without. Some simple experimentation should make this action clear.
  133.  
  134.     Data may by drag and dropped into the From text edit box, and may be dragged from either text edit box.
  135.  
  136.     Multiple monitors, if you have them, are supported.  This means that you can drag your Convert window to any desired located, even on to a second display, if available. This feature really comes in handy if you are running multiple applications at once and need to "spread out."
  137.  
  138.  
  139. Help
  140.     Since you are running under Mac OS 7.x or later, you may take advantage of Balloon Help. Simply select the "Show Balloons" menu item from the Balloon Help menu in the upper-right corner of your menu bar. See your Macintosh manual for further instructions on how to activate Balloon Help.
  141.  
  142.  
  143. Scripting
  144.     Convert is scriptable, meaning that the required AppleEvents are supported.
  145.  
  146.  
  147. Troubleshooting
  148.  
  149.     The minimum system configuration you will need to successfully run Convert is a Macintosh Plus (or later) with 1 MB RAM and Mac OS version 7.x or greater. Convert will not run under Macintosh System 6.x or earlier.
  150.  
  151.     All of Convert’s "remembered" settings, including window location and Currency prices, can be reset by throwing away the "Convert Preferences" file. This file is located in the Preferences folder, which can be found within the System Folder.
  152.  
  153. NOTE: Updated versions of Convert may be released that require new or different information in the  "Convert Preferences" file. If possible, Convert will automatically update your  "Convert Preferences" file to the current version. Unfortunately, this process may result in your preferences being reset to the factory defaults.
  154.  
  155.     You can determine what version of Convert you have by either selecting the About Convert… menu item under the Apple menu (shown below), or by selecting the Convert icon within the Finder and then selecting the Get Info… menu item (located under the File menu).
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.                                                                                     About Convert™… Dialog Box
  172.  
  173.  
  174. If there are any problems, suggestions, or bug reports, please contact Fifth Wave immediately at fwsupport@fifthwave.com.
  175.  
  176.  
  177. Disclaimer of Warranty and Limited Warranty on Media
  178. Fifth Wave will replace defective distribution media or manuals at no charge, provided you return the item to be replaced with proof of purchase to Fifth Wave during the 90-day period after purchase. ALL IMPLIED WARRANTIES ON THE MEDIA AND MANUALS, INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ARE LIMITED IN DURATION TO NINETY (90) DAYS FROM THE DATE OF THE ORIGINAL RETAIL PURCHASE OF THIS PRODUCT.
  179.  
  180. FIFTH WAVE MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO CONVERT SOFTWARE, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. AS A RESULT, CONVERT IS LICENSED "AS IS," AND YOU THE PURCHASER ARE ASSUMING THE ENTIRE RISK AS TO ITS QUALITY AND PERFORMANCE.
  181.  
  182. IN NO EVENT WILL FIFTH WAVE BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT IN CONVERT OR ITS DOCUMENTATION, even if advised of the possibility of such damages. In particular, Fifth Wave shall have no liability for any data calculated using Convert, or for the consequences of using such data.
  183.  
  184. THE WARRANTY AND REMEDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL OTHERS, ORAL OR WRITTEN, EXPRESS OR IMPLIED. No Fifth Wave dealer, agent, or employee is authorized to make any modification, extension, or addition to this warranty. Some states do not allow exclusion or limitation of implied warranties or liability for incidental or consequential damages, so the-above limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may also have other rights which vary from state to state.
  185.  
  186. Copyright Notice
  187. The Convert manual (this document, regardless of medium (electronic or physical)), program, product design, and design concepts are Copyrighted, with all rights reserved to Fifth Wave. Your rights are subject to the limitations and restrictions imposed by the copyright laws of the United States of America. Under the copyright laws, this manual may not be copied, in whole or part, including translation to another language or format, without the express written consent of Fifth Wave.
  188.  
  189.      © Copyright 1993-1999 Fifth Wave, John M. Dasher. All rights reserved.
  190.  
  191.             Fifth Wave
  192.             1627 Via Campo Verde
  193.             San Jose, CA  95120
  194.             USA
  195.  
  196.             Telephone: 408/927-5108
  197.  
  198.             email: fwinfo@fifthwave.com
  199.  
  200. Trademarks
  201. Apple®, the Apple logo, Macintosh®, and Mac OS® are registered trademarks of Apple Computer, Inc.